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CLAIMS 

What is claimed is: 

1 . A method of debugging an application comprising Java code and native 

method dynamic load libraries, ttie method operating in a computer having an 
5 operating system, a system debug application programming interface (API), 

and a Java Virtual Machine having a Java Platform Debugger Architecture 
Virtual Machine Debug Interface API, said method comprising the steps of: 
launching a Java virtual machine under the system debug API; 
executing the application under the Java virtual machine; and 
10 simultaneously debugging the Java code and the native method 

(fynamic load libraries as the application is executing under the Java virtual 
machine, wherein the Java code is debugged using the Java Platform Debugger 
Architecture Virtual Machine Debug Interface API and wherein the native 
method dynamic load libraries are debugged using the system debug API. 
15 2, The method as described in Claim 1 wherein the step of simultaneously 

debugging the Java code and the native method dynamic load libraries includes 
providing and displaying a console message window which permits a 
user to view output printed by the application. 
3 . The method as described in Claim 2 wherein said step of providing and 
20 displaying a console message window includes the steps of: 

obtaining a Process object from the virtual machine; 
obtaining an InputStream object from the Process object, 
creating a "BufferedReader" object; and 
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using a read method to retrieve data from the application. 

4. The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and the native method dynamic load libraries includes 
providing and displaying a console message window which permits a 

user to write data to the application. 

5. The method as described in Claim 4 wherein said step of providing and 
displaying a console message window includes the steps of: 

obtaining a Process object from the virtual machine; 
obtaining an OutputSfream object from the Process object, 
creating a "BufferedWriter" object; and 
using a write method to write data to the application. 

6. The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and flie native method dynamic load libraries includes 
providing the ability to exclude classes when stepping execution by use of an 
asterisk when invoking an "addClassExclusionFilter" method on a step request 
object . 

7. The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and the native method dynamic load libraries includes 
providing string evaluation wifli a SteingReference interface which extends an 
ObjectReference such that a string is treated as a class. 

8. The method as described in Claim 1 wherein tiie step of simultaneously 
debugging the Java code and the native method dynamic load libraries includes 
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modifying symbols such as static and instance fields, strings, array elements, 
and Booleans, by: 

invoking a mirrorOf utility to obtain an access reference to a type of 
symbol to be modified; and 
5 invoking a setValue utility to modify the value of the symbol. 

9. The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and the native method dynamic load libraries includes 
setting a breakpoint by: 

obtaining a list of the loaded classes; 
1 0 obtaining line number information from a class object; 

instantiating a breakpoint request; 
setting the brealq)oint request suspend policy; and 
enabling the breakpoint request. 

10. The method as described in Claim 9 wherein the step of setting a breakpoint 
15 further comprises adding the breakpoint to a deferred breakpoint table if the 

class where the breakpoint is to be located is not already loaded 

1 1 . The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and flie native method dynamic load libraries includes 
loading classes by: 

20 obtaining a reference to a method "getSystemClassLoader"; and 

invoking said method to load a class. 
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1 2. The method as described in Claim 1 wherein the step of simultaneously 
debugging the Java code and the native method dynamic load libraries includes 
stepping through execution of the application by: 

obtaining an event request manager from the virtual machine; 
5 invoking a method of the event request manager to create a new step 

request including a step size parameter; 

enabling the new step request; and 
resuming the virtual machine. 

1 3 . The method as described in Claim 1 wherein the step of simultaneously 

10 debugging the Java code and the native method dynamic load libraries includes 

handling events from the virtual machine by: 

providing a plurality of event handlers, one event handler for each 
requested event object to be processed; 

polling a virtual machine event queue to determine if any requested 
15 event objects are queued; 

removing requested event objects from the event queue; 
determining the event object type; and 

calling an event handler according to the determined event object type. 

14. A computer-readable medium containing program code for a software 

20 development workstation for debugging an application comprising Java code 

and native method dynamic load libraries, the software development 
workstation comprising a computer with an operating system, a system debug 
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application programming interface (API), and a Java Virtual Machine having a 
Java Platform Debugger Architecture Virtual Machine Debug Interface API, 
said program code when executed by said computer causing said computer to 
perform the steps of: 

launching a Java virtual machine under the system debug API; 
executing the application under the Java virtual machine; and 
simultaneously debugging the Java code and the native method 
dynamic load libraries as the ^plication is executing under the Java virtual 
machine, wherein the Java code is debugged using the Java Platform Debugger 
Architecture Virtual Machine Debug Interface API and wherein the native 
method dynamic load libraries are debugged using the system debug API. 

1 5 . The computer readable medium as described in Claim 1 4 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native method dynamic load libraries includes program code for providing 
and displaying a console message window which permits a user to view ou^ut 
printed by the qjplication. 

16. The computer readable medium as described in Claim 15 wherem program 
code for performing the step of providing and displaying a console message 
window includes program code for performing the steps of: 

obtaining a Process object from the virtual machine; 
obtaining an InputSti-eam object from the Process object, 
creating a "BufferedReader" object; and 
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using a read method to retrieve data from the application, 

1 7. The computer readable medium as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native method dynamic load libraries includes program code for providing 

5 and displaying a console message window which permits a user to write data 

to the application. 

1 8. The computer readable medium as described in Claim 17 wherein said 
program code for performing the step of providing and displaying a console 
message window includes program code for performing the steps of: 

10 obtaining a Process object from the virtual machine; 

obtaining an OutputStream object from the Process object, 

creating a "BufferedWriter" object; and 

using a write method to write data to the application. 

1 9. The computer readable medium as described in Claim 14 wherein program 
15 code for performing the step of simultaneously debugging the Java code and 

the native method dynamic load libraries includes program code for providing 
the ability to exclude classes when stepping execution by use of an asterisk 
when invoking an addClassExclusionFilter method on a step request object . 

20. The computer readable medium as described in Claim 14 wherein program 
20 code for performing the step of simultaneously debugging the Java code and 

the native method dynamic load libraries includes program code for string 
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evaluation with a StringReference interface which extends an ObjectReference 
such that a string is treated as a class. 

21 . The computer readable mediunfi as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 

5 the native method dynamic load libraries includes program code for modifying 

symbols such as static and instance fields, strings, array elements, and 
Booleans, by: 

invoking a mirrorOf utility to obtain an access reference to a type of 
symbol to be modified; and 
1 0 invoking a setValue utility to modify the value of the symbol 

22. The computer readable medium as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native method dynamic load libraries includes program code for setting a 
breakpoint by: 

15 obtaining a list of the loaded classes; 

obtaining line number information from a class object; 

instantiating a breakpoint request (107); 

setting the brealq)0int request suspend policy; and 

enabling the breakpoint request. 
20 23 » The computer readable medium as described in Claim 22 wherein program 

code for performing the step of setting a breakpoint further comprises program 
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code for adding the breakpoint to a deferred breakpoint table if the class where 
the breakpoint is to be located is not already loaded. 

24. The computer readable medium as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native method dynamic load libraries includes program code for loading 
classes by: 

obtaining a reference to a method "getSystemClassLoader"; and 
invoking said method to load a class. 

25. The computer readable medium as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native mettiod dynamic load libraries includes program code for stepping 
through execution of the application by: 

obtaining an event request manager from the virtual machine; 
invoking a method of the event request manager to create a new step 
request including a step size parameter; 

enabling the new step request; and 
resuming the virtual machine. 

26. The computer readable medium as described in Claim 14 wherein program 
code for performing the step of simultaneously debugging the Java code and 
the native method dynamic load libraries includes program code for handling 
events from the virtual machine by: 
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providing a plurality of event handlers, one event handler for each 
requested event object to be processed; 

polling a virtual machine event queue to determine if any requested 
event objects are queued; 
5 removing requested event objects from the event queue; 

determining the event object type; and 

calling an event handler according to the determined event object type. 

27. A computer, comprising: 

a processor; 

10 an operating system having a system debug application progranuning 

interface (API); 

a Java interpreter having an associated Java Platform Debugger 
Architecture API for running an application program under a Java Virtual 
Machine; 

1 5 a Java probe means for accessing and controlling an application 

program being executed by said Java Virtual Machine via said Java Platform 
Debugger Architecture API; and 

a debugger engine daemon, communicative to said Java probe, for 
simultaneously debugging the Java code and native method dynamic load 

20 library code in coordination with said probe means, 

28. The computer as described in claim 27 wherein the debugger engine daemon is 
adapted to debug native method dynamic load libraries of the application under 
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the system debug API and the Java probe is adapted to debug Java application 
code under the Java Platform Debugger Architecture. 

29. The computer as described in claim 27 further comprising a console message 
window means capable of reading data ftom the application and displaying it 

5 to a user, said console message window means comprising: 

a Process object obtained from the virtual machine; 
an InputStream object obtained from the Process object, 
a "BufFeredReader" object; and 

a read method adapted to retrieve data from the application and display 
10 the retrieved data on a console message window display. 

30. The computer as described in claim 27 further conprising a console message 
window means capable of writing data to the application under user control, 
said console message window means comprising: 

a Process object obtained from the virtual machine; 
15 an OutputStream object obtained from the Process object, 

a "BufferedWriter" object; and 

a write method adapted to write data to the application from a console 
message window display. 

3 1 . The computer as described in claim 27 further comprising a class excluder 
20 adapted to exclude classes when stepping program execution by use of an 

asterisk when invoking an "addClassExclusionFiltef method on a step request 
object 
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32. The computer as described in claim 27 further comprising a string evaluator 
with a StringReference mterface which extends an ObjectReference such that a 
string is treatable as a class. 

33 . The computer as described in claim 27 flirflier comprising a symbol modifier 
5 for modifying symbols such as static and instance fields, strings, array 

elements, and Booleans, comprising: 

a mirrorOf utility invoker adapted to obtain an access reference to a 
type of symbol to be modified; and 

a setValue utility invoker adapted to modify the value of the symbol. 
10 34. The computer as described in claim 27 further comprising a breakpoint setter 
comprising: 

a list of the loaded classes obtained from the virtual machine; 
line number information obtained fi:om a class object; 
a instantiated breakpoint request; 
15 a breakpoint request suspend policy; and 

a breakpoint request enabler, 
35. The computer as described in claim 34 wherein said breakpoint setter further 
comprises a deferred breakpoint table for storing breakpoints for classes which 
are not currently loaded. 
20 36. The computer as described in claim 27 further comprising an execution stepper 
con5)rising: 

an event request manager obtained from the virtual machine; 
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a new step request method invoker for invoking a method of the event 
request manager to create a new step request including a step size parameter; 

a new step request enabler; and 

a virtual machine resumer. 
5 37. The computer as described in claim 27 further comprising an event handler for 
handhng events from the virtual machine comprising: 

a plurality of event type handlers, one event type handler for each 
requested event object type to be processed; 

an event queue poller for polling the virtual machine to determine if any 
1 0 requested event objects are queued; and 

an event type handler sorter for determining the event object type and 
calling an event type handler. 
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